docs: require that a stated verification result was actually produced - #132
Closed
toruiwasa wants to merge 1 commit into
Closed
docs: require that a stated verification result was actually produced#132toruiwasa wants to merge 1 commit into
toruiwasa wants to merge 1 commit into
Conversation
Issue #126 (since deleted) reported that SDLC.md "has never existed in the repo" on three grounds. Two of them — absent from the working tree, absent from `git ls-files` — were written in the past tense without being executed, and both were false: the file was present, tracked, and six revisions deep. The third was run and read backwards; `--diff-filter=D` returning nothing proves the file was never deleted, not that it never existed. Nothing caught it, because a fabricated claim reads exactly like a measured one. The issue was proposed in a plan, approved on the strength of those claims, filed, worked on and closed before anyone opened the file. Adds a Key Principles bullet beside Library-source-first debugging: never state a verification result that was not produced; run the positive control before concluding absence; verify claims about this repository the same way as claims about a third-party library. Closes #131 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Owner
Author
|
Withdrawn at the user's instruction. A rule written from a single in-session mistake is not worth carrying, and a prohibition of this shape risks over-constraining ordinary work. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #131
What this adds
One bullet under Key Principles, next to Library-source-first debugging:
Plus two habits underneath it: run the positive control before concluding absence, and verify claims about this repository the way you verify claims about a library.
Why it is written down rather than assumed
Issue #126, since deleted, reported that
SDLC.md"has never existed in the repo" on three grounds. Two were never executed and were false.SDLC.mdwas present at 7,652 bytes, tracked by git, added in89b7361on 2026-06-21 and revised six times, most recentlyaabd5b5(PR #79). The third ground was executed and inverted:git log --diff-filter=D -- '*SDLC*'returning nothing proves the file was never deleted;--diff-filter=Areturns the adding commit on the first try.The mechanism worth naming is that nothing caught it. A fabricated claim is indistinguishable from a measured one to every later reader, so it passed through a plan, an explicit approval given on the strength of those claims, a filing, a work item and a close — and surfaced only when the file was independently opened. The cost compounded: #126 also argued no documented fast path existed for a docs-only change, while
SDLC.md§ Fast Paths already carried one, and its Dependabot fast path already stated the rule that #124 / PR #125 went on to follow by coincidence rather than by reading it.The alternative, and why it lost
Leaving it undocumented was argued on the grounds that verifying a claim before asserting it is baseline conduct rather than a project convention, and that a rule written after the fact supplies a citation for the next occurrence instead of preventing anything. That objection is sound in general and is recorded in #131 so it does not have to be re-argued. It does not apply here: the behaviour was demonstrably treated as optional, and the evidence against "too obvious to write down" is the incident that raised the question.
Verification
Documentation only — no code, no CI, no dependency change. The claims in this PR body were produced by
git log,git ls-filesandwc -cagainstmainat85eaedfbefore it was written.